home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / pcboard / cw_cj_40.zip / CONFJOIN.DOC < prev    next >
Text File  |  1994-06-01  |  15KB  |  278 lines
  1.      ┌────────────────────────────────────────────────────────────────────┐
  2.      │ ConfJoin    PCBoard 15.1 PPE    J Command Replacement  <Shareware> │
  3.      └────────────────────────────────────────────────────────────────────┘
  4.  
  5.      ConfJoin is the ULTIMATE conference Join PPE utility for PCBoard 15.1
  6.      ConfJoin is also the BEST way to never have to draw CNFN menus again!
  7.  
  8.      ConfJoin can  display which conferences have file directories, doors,
  9.      bulletins, which are echoed and which are private! You made a change?
  10.  
  11.      Make your PCB J command customized for the networks your BBS carries!
  12.      Group your conferences by network name, or conference type!  ConfJoin
  13.      supports up to 32 groups/networks, even in the unregistered version!!
  14.  
  15.      ConfJoin works in 3 modes!  In Mode A you can have your own menu dis-
  16.      played (or ConfJoin can DRAW them for you), In Modes B/C it will scan
  17.      CNAMES file and create it's own CNAMES.TXT for very fast "On The Fly"
  18.      menus!!  You would never have to draw another conference menu again!!
  19.      And ConfJoin KNOWS when CNAMES is changed  and can update your menus!
  20.      Mode B uses conference name prefixes,  Mode C  uses conference number
  21.      ranges. There is plenty of flexibility in this puppy...
  22.  
  23.      Use ConfJoin as a J command replacement and offer your users the very
  24.      best way to  scan for  or  join  conferences  on your bulletin board.
  25.  
  26.                             Nothing Beats ConfJoin!
  27.  
  28.  
  29.      ┌────────────────────────────────────────────────────────────────────┐
  30.      │ Installation                                              ConfJoin │
  31.      └────────────────────────────────────────────────────────────────────┘
  32.  
  33.      Installation of  ConfJoin  is really very simple.  ConfJoin should be
  34.      installed in your CMD.LST as a replacement for the J command. Go into
  35.      PCBSetup CMD.LST section  (B: File Locations, B: Configuration Files)
  36.      Now go to the CMD.LST section and F2 to edit it. Add a line as shown:
  37.  
  38.      Command       Security      PPE/MNU File -or- Keystroke Replacement
  39.      =======       ========      ========================================
  40.         J             5           E:\PCB\PPE\CONFJOIN.PPE
  41.  
  42.      Make the security level at whatever you desire,  it is a good idea to
  43.      make it the same as you defined in the "User Security Levels" section
  44.      of PCBSetup. Lastly, then add the full path and filename to ConfJoin.
  45.      For more info on CMD.LST see PCB docs.
  46.  
  47.  
  48.      ┌────────────────────────────────────────────────────────────────────┐
  49.      │ Config File (CONFJOIN.CNF)                                ConfJoin │
  50.      └────────────────────────────────────────────────────────────────────┘
  51.      The CONFJOIN.CNF file must be placed in the same dir as CONFJOIN.PPE.
  52.      A Sample CNF file is explained below and MUST be called CONFJOIN.CNF.
  53.  
  54.      Line  1    BBS registered to ........  Your BBS Name
  55.      Line  2    Registration number ......  00000
  56.      Line  3    Validation code ..........  00000
  57.      Line  4    Mode A B or C operation ..  C
  58.  
  59.      Mode A
  60.      Mode A is the fastest, but you must first draw all of the network menu
  61.      screens yourself. In Mode A, ConfJoin will display whatever menus you
  62.      have created. This method is faster than in Mode B or C but if you make
  63.      any changes, then you must also update the menu. If you want automatic,
  64.      use Mode B or C.
  65.  
  66.      Mode B
  67.      This is if you want "On The Fly" menus to be made by ConfJoin when your
  68.      conference names have two-letter prefixes (IN_NetAdmin for Intelec,  or
  69.      PE_Politics for Planet Earth, etc). Mode B uses a high conference number
  70.      for additional display speed. You will have to use a "table" file for
  71.      this info (see below). In Mode B, ConfJoin shows which confs have file
  72.      directories, which are private, which have bulletins, doors, and which
  73.      are echoed! When you add new conferences you can rest assured you don't
  74.      have to update any conference menus ever again.
  75.  
  76.      Mode C
  77.      This is if you want "On The Fly" menus to be made by ConfJoin but your
  78.      conference names do NOT use any prefixes at all. This mode of operation
  79.      relies on you to supply the range of conferences that this network or
  80.      group uses. You'll have to use a "table" file for this info (see below).
  81.  
  82.      What are On The Fly menus?
  83.  
  84.      These are menus that ConfJoin creates as soon as the J command is used.
  85.      Since they're made "on the fly" (and FAST!) they're always up to date!!
  86.  
  87.      If you want to use "On The Fly" menus, you must have one of two things
  88.      utilized in your conference naming. You must either use prefixes to ID
  89.      the various nets you carry, this is the preferred method. If not, you
  90.      must have your network conferneces in contigious blocks in CNAMES. You
  91.      can't have 25 Intelec confs, 50 RIME confs, 40 Intelec confs, 20 RIME,
  92.      etc. If your network conferences are all over the place and you do NOT
  93.      use "prefixes", you are an accident waiting to happen, and ConfJoin is
  94.      not going to work for you. Clean up the mess and then try it again....
  95.  
  96.  
  97.      ┌────────────────────────────────────────────────────────────────────┐
  98.      │ The ConfJoin Table File (Table of network names/numbers)  ConfJoin │
  99.      └────────────────────────────────────────────────────────────────────┘
  100.      The ConfJoin Table file must be placed in the same dir as CONFJOIN.PPE
  101.      If using Mode A it must be called MODE_A.TBL, and if using Mode B or C
  102.      it must be called MODE_BC.TBL.  Also, if you want to use Mode A you'll
  103.      need to use the CJ_A.PPE and *rename* it to CONFJOIN.PPE. Anyway, sam-
  104.      ples of these table files are explained below:
  105.  
  106.        MODE_A.TBL                What Each Line Means
  107.      ┌───────────────────┐      ----------------------
  108.      │ E:\PCB\PPE\CJMENU │   Line 1   Main "Networks" menu
  109.      │ 3                 │   Line 2   Total networks or groups
  110.      │                   │   Line 3   Blank line
  111.      │ Intelec Network   │   Line 4   1st Network's Name
  112.      │ D:\PPE\CJ\CJ_01   │   Line 5   Path to this net's menu
  113.      │                   │   Line 6   Blank line
  114.      │ Planet Earth      │   Line 7   2nd Network's Name
  115.      │ D:\PPE\CJ\CJ_02   │   Line 8   Path to this net's menu
  116.      └───────────────────┘
  117.      (and so on for up to 32 networks or conference groups)
  118.  
  119.  
  120.        MODE_BC.TBL                     What Each Line Means
  121.      ┌─────────────────────────┐      ----------------------
  122.      │ E:\PCB\PPE\CJMENU       │  Line  1    Main "Network List" Menu
  123.      │ E:\PCB\PPE\CONFJOIN.CO9 │  Line  2    Color config file to use
  124.      │ Closed                  │  Line  3    Conference name to "mask"
  125.      │ 2                       │  Line  4    Total networks or groups
  126.      │                         │  Line  5    Blank line
  127.      │ Intelec Network         │  Line  6 ** 1st network's name
  128.      │ IN                      │  Line  7  * Prefix (IN_) if using Mode B
  129.      │ 1                       │  Line  8    This network's low conf #
  130.      │ 300                     │  Line  9    This network's high conf #
  131.      │                         │  Line 10    Blank line
  132.      │ Planet Earth            │  Line 11 ** 2nd network's name
  133.      │ PE                      │  Line 12  * Prefix (PE_) if using Mode B
  134.      │ 301                     │  Line 13    This network's low conf #
  135.      │ 322                     │  Line 14    This network's high conf #
  136.      └─────────────────────────┘
  137.      (and so on for up to 32 networks or conference groups)
  138.      * If using Mode C, you can leave this line blank also. It is only used
  139.        for Mode B where conference name prefixes (ie IN_NetAdmin) are used.
  140.     ** You can use up to 30 characters (maximum) for the network's name.
  141.  
  142.  
  143.      ┌────────────────────────────────────────────────────────────────────┐
  144.      │ The CONFJOIN.CO# File    (Color file for Modes B and C)   ConfJoin │
  145.      └────────────────────────────────────────────────────────────────────┘
  146.      The CONFJOIN.CO# files must be placed in the same dir as CONFJOIN.PPE.
  147.      Sample color file is explained below and can be called anything you
  148.      like.  This is the filename you placed on line 2 of the table file.
  149.  
  150.      Line  1   Background
  151.      Line  2   @X00
  152.      Line  3   Line 1 (Upper Left)
  153.      Line  4   @X0A
  154.      Line  5   Line 2 (Lower Right)
  155.      Line  6   @X0A
  156.      Line  7   FDEBP Legend
  157.      Line  8   @X0E
  158.      Line  9   FDEBP Conf Flags
  159.      Line 10   @X0F
  160.      Line 11   Network Name
  161.      Line 12   @X0E
  162.      Line 13   Conference Name
  163.      Line 14   @X0B
  164.      Line 15   Conference Number
  165.      Line 16   @X0D
  166.  
  167.      This is all pretty explanatory but... I'll give it a shot anyway. All
  168.      the odd numbered lines are just descriptions of what the line below
  169.      them (even numbered) represent. I've included several color files in
  170.      this release so you can play around with different options. The only
  171.      ones that really needs explanation are lines 4 and 6 (Line 1 and 2).
  172.      I've separated the lines into two so that you can make them 2 different
  173.      colors to give background colors more depth. You'll have to try CO1-CO5
  174.      to see what I'm feebly trying to explain.
  175.  
  176.  
  177.  
  178.      ┌────────────────────────────────────────────────────────────────────┐
  179.      │ The CNAMES.TXT File (For FASTER Scanning With Modes B/C!) ConfJoin │
  180.      └────────────────────────────────────────────────────────────────────┘
  181.  
  182.      When using Mode B or C, ConfJoin scans your CNAMES file and create its
  183.      own CNAMES.TXT file in the ConfJoin directory.  It pulls only the info
  184.      it needs from CNAMES so that it has less to "read in" when making it's
  185.      "On The Fly" menus. And if you make a change add or drop a conference,
  186.      ConfJoin knows when CNAMES was modified and RE-scans a new CNAMES.TXT.
  187.      Again, one LESS thing for you to deal with or need to put in an event.
  188.      If you make a change to your table file, delete the CNAMES.TXT file in
  189.      the ConfJoin PPE directory and ConfJoin will rescan it for you!
  190.  
  191.  
  192.      ┌────────────────────────────────────────────────────────────────────┐
  193.      │ The DRAW Command!  (Let ConfJoin Draw Your Menus!)        ConfJoin │
  194.      └────────────────────────────────────────────────────────────────────┘
  195.  
  196.      Say you want to use Mode A with pre-existing menus for each network...
  197.      ConfJoin can DRAW all your menus for you! But here's what you must do:
  198.      You must be in Mode B or C (as defined in your CONFJOIN.CNF file). You
  199.      must have a Mode B or C table file (with the prefixes, conf ranges and
  200.      the color definition file).  Logon locally and type J to run ConfJoin,
  201.      then type the DRAW command. It will ask you once for your * validation
  202.      number so that users or other SysOps do not spend your time rescanning
  203.      menus.  If you are unregistered, not to worry,  enter any 5 digit code
  204.      on the ValCode line of the CONFJOIN.CNF file. It will still display as
  205.      unregistered but this way only YOU will be able to draw menus as users
  206.      can enter 0's. Then it will ask you which network to draw. If you type
  207.      1 then it "draws" the file CJ_01  based on the parameters in the table
  208.      file for network/group 1.  It will only draw one network or group at a
  209.      time in case you are only "modifying" one network or group. It is rare
  210.      that someone makes changes to *every* network or group on their BBS at
  211.      the same time. Anyway, when all the CJ_01, CJ_02, etc, files are made,
  212.      you can then switch over to the Mode A table file (MODE_A.TBL).  Also,
  213.      rename the CJ_A.PPE to CONFJOIN.PPE and change line 4 of your ConfJoin
  214.      config file (CONFJOIN.CNF) to show you are now operating in Mode A.
  215.  
  216.  
  217.      ┌────────────────────────────────────────────────────────────────────┐
  218.      │ Changes!  (What's NEW In This Release!)                   ConfJoin │
  219.      └────────────────────────────────────────────────────────────────────┘
  220.  
  221.      Changes/Fixes in version 4.0 (3.9 not released)
  222.      Now bundled with DoorMenu, FileMenu, and MainMenu! That's 4 great PPEs
  223.      for the price of 1!! Also did minor code tweaking but it's pretty much
  224.      tweaked out...
  225.  
  226.      Changes/Fixes in version 3.8
  227.      We split off ConfJoin to two PPE's. One is called CJ_A.PPE and this is
  228.      for those wanting to use Mode A only. But before using it rename it to
  229.      CONFJOIN.PPE or it will not work. The other PPE is called CONFJOIN.PPE
  230.      already. This is the one we've all come to know and love that operates
  231.      in Modes B or C. If you use it in either Mode B or C only, this is the
  232.      PPE to use.
  233.      We also split the ConfJoin table file  (CONFJOIN.TBL for those using B
  234.      or C modes already) to two files:  MODE_A.TBL and MODE_BC.TBL.  If you
  235.      are using Modes B or C you just rename CONFJOIN.TBL to MODE_BC.TBL. If
  236.      you are using Mode A, rename it to MODE_A.TBL but check these docs for
  237.      the correct format of MODE_A.TBL, as it's been made alot simpler since
  238.      Mode A operates in a much simpler manner.
  239.  
  240.      Changes/Fixes in version 3.7
  241.      Added a new feature where the user(s) will have the ability to reset
  242.      those pesky "mail-waiting" flags. This option will ONLY work when
  243.      ConfJoin is operating in Mode C. This is because it needs to know what
  244.      the low and high conference numbers for any network or group are and
  245.      these numbers are only used in Mode C. But Mode C is the best anyway.
  246.  
  247.      Changes/Fixes in version 3.6
  248.      Now will not display conference "without names". If you do not have a
  249.      name in the conference name field, it will not be displayed by ConfJoin
  250.      as this has been requested by many folks to operate this way. Thanks.
  251.  
  252.      Changes/Fixes in version 3.5
  253.      Minor code tweaking, nothing major.
  254.  
  255.      Changes/Fixes in version 3.4
  256.      Alot of you asked for the ability to configure your own colors. I hear
  257.      and I obey. There is now a color file ConfJoin will read in. Also, you
  258.      asked for the ability to use conference range numbers and now you can!
  259.      Also, no longer will you need to use conference name prefixes  such as
  260.      IN_NetAdmin or IL_Politics. Tho you still can, it's no longer required
  261.      for on the fly menu screens.
  262.  
  263.      Changes/Fixes in version 3.3
  264.      Fixes a bug where when scanning ALL conferences the last line would be
  265.      duplicated when the last line consisted of 3 conference names. If only
  266.      two conference names were on the last line it would correctly show the
  267.      last as a blank, but 3 conference names caused the double line, fixed.
  268.  
  269.      Changes/Fixes in version 3.2
  270.      Changed reference of mode 1 and 2 to modes A and B for less confusion.
  271.      Also, ConfJoin creates its own smaller CNAMES.TXT in the ConfJoin dir.
  272.      It GREATLY speeds up scans if using Mode B. Also added a DRAW command!
  273.      Lastly... for consistancy we have changed the CNF file format if using
  274.      Mode A  to have a network (or group) name  keeping CNF file consistant
  275.      with Mode B operation.  Also, when adding the A/B toggle  we messed up
  276.      the sequence in which  the CNF file was read in, fixed.
  277.  
  278.